Root claim #2053

shamil-gadelshin · 2025-09-12T10:25:46Z

Root Claim / Airdrop

This PR introduces a root claim (airdrop) mechanism. It replaces the automatic selling of root-alpha dividends with accumulation. Users can either:

Manually claim their accumulated share, or
Enable auto-sell, which automatically sells the accumulated share daily and transfers the proceeds to their account.

New extrinsics

set_root_claim_type — Set root-claim mode: auto or manual.
claim_root — Manually claim accumulated root dividends.

Storage changes

PendingRootAlphaDivs — Tracks root-alpha dividends between epochs.
RootClaimType — User’s preferred claim mode (auto or manual).
RootClaimable — User’s claimable share of alpha dividends.
RootClaimed — Accounting helper for alpha dividends (stake changes, claimed amounts).
StakingColdkeysByIndex — Supports randomized distribution of auto-claims per block.
StakingColdkeys — Supports root-dividends distribution.
NumStakingColdkeys — Count to support randomized auto-claim distribution per block.
NumRootClaim — Number of auto-claims to fulfill for a subnet in the current epoch.
AlphaMapLastKey — Supports staking coldkey migration.

Removed (obsolete storage maps)

TaoDividendsPerSubnet
PendingAlphaSwapped

Original PRs

…bnets

pallets/subtensor/src/coinbase/run_coinbase.rs

camfairchild · 2025-10-14T11:30:36Z

pallets/subtensor/src/staking/claim_root.rs

+            .checked_div(total)
+            .unwrap_or(I96F32::saturating_from_num(0.0));
+
+        if u64::from(amount) > total.saturating_to_num::<u64>() {


While I think this should never happen we should probably add it to their alpha stake or something.

Correct me if I'm wrong, but it will be the same, as we'll give everything to the validator owner.

I introduced this check during the testing. Incorrect test setup produced unexpected results. It's unlikely that we have this on mainnet. And if we do have this condition - we chose a safe route.

I'm open to suggestions here.

Like the remainder goes to the vali owner? That sounds right

Here is the fix: Handle case for stake mismatch.

pallets/subtensor/src/staking/claim_root.rs

pallets/subtensor/src/staking/helpers.rs

Co-authored-by: Cameron Fairchild <[email protected]>

Swamination-Yuma · 2025-10-14T16:41:42Z

Making a note from OpenDev - to assure this handles dereg liquidation scenarios.

camfairchild

we need to handle subnet de-reg as well. We should just claim the whole pool when the de-reg happens

pallets/subtensor/src/swap/swap_hotkey.rs

pallets/subtensor/src/swap/swap_coldkey.rs

camfairchild · 2025-10-14T17:21:04Z

pallets/subtensor/src/staking/claim_root.rs

+            continue;
+        }
+
+        weight


maybe we should try to grab more if some don't meet the claim threshold

It introduces a rather awkward interface. I increased the auto-key claims instead. We had roughly a day previously, a week after a conversation with Const. I doubled the value.

pallets/subtensor/src/migrations/migrate_remove_tao_dividends.rs

camfairchild · 2025-10-15T15:12:51Z

Note from nucleus call:

make sure auto claim threshold is per-subnet. Don't claim tiny amounts of any subnet automatically

shamil-gadelshin

make sure auto claim threshold is per-subnet. Don't claim tiny amounts of any subnet automatically

We have one threshold for all operations. Is there a reason to introduce a map of thresholds?

UPDATE: I implemented the per-subnet threshold anyway.

pallets/subtensor/src/migrations/migrate_remove_tao_dividends.rs

shamil-gadelshin · 2025-10-17T13:50:15Z

pallets/subtensor/src/staking/claim_root.rs

+            continue;
+        }
+
+        weight


It introduces a rather awkward interface. I increased the auto-key claims instead. We had roughly a day previously, a week after a conversation with Const. I doubled the value.

shamil-gadelshin · 2025-10-17T13:51:14Z

pallets/subtensor/src/staking/claim_root.rs

+        weight
+    }
+
+    pub fn change_root_claim_type(coldkey: &T::AccountId, new_type: RootClaimTypeEnum) {


We could reindex these maps each 6-12month.

sam0x17 · 2025-10-17T15:48:01Z

looks like some CI failures tho

Swamination-Yuma · 2025-10-17T17:00:44Z

Has someone communicated with the Bittensor SDK v10 devs to account for any changes (for the auto/manual setting and the storage map adds & removals)? May be nothing, but I was not sure offhand if directly handled since no mention in the v10 migration guide.

github-actions · 2025-10-17T21:10:54Z

@opentensor/cerebrum / @opentensor/gyrus / @opentensor/cortex breaking change detected! Please prepare accordingly!

shamil-gadelshin · 2025-10-20T12:28:19Z

Has someone communicated with the Bittensor SDK v10 devs to account for any changes (for the auto/manual setting and the storage map adds & removals)? May be nothing, but I was not sure offhand if directly handled since no mention in the v10 migration guide.

Yes. The SDK team was going to work on the required changes after the merge. cc @basfroman

shamil-gadelshin added 3 commits September 10, 2025 12:59

Add root claim infrastructure

2f7ea4b

Alter coinbase.rs

c579597

Alter tests

6c614fe

shamil-gadelshin requested a review from gztensor September 12, 2025 10:25

shamil-gadelshin self-assigned this Sep 12, 2025

shamil-gadelshin and others added 25 commits September 12, 2025 14:32

Remove comments

e04c8e9

Change TaoDividendsPerSubnet -> AlphaDividendsPerSubnet

f607993

Fix: PendingAlphaSwapped only needs to increase for non-subsidized su…

8877c40

…bnets

Update tests

e7605df

Update coinbase.rs

c48a9c4

Cargo fmt

9fa484a

Remove TaoDividendsPerSubnet

7f5dba4

Remove PendingAlphaSwapped

28e2f74

Rename RootDebt -> RootClaimed

eb32237

Fix RootClaimable map

2e613b0

Add root claim tests.

b125673

Add basic test with drain_emissions

0151f49

Update tests.

83b2b36

Update tests

c482f2f

Simplify tests

55c1b1d

Add disproportional stake test

a11d7a9

Add test with removed stake.

e3cc8e1

Fix existing tests

dd44dd8

Update tests

0b13d2e

Fix swap claim root

8d1140d

Add basic run_coinbase test

65bb4f0

Fix block indices to claim

1accdfa

Optimize RootClaimable

c09bcb3

Update benchmarks

fc161b3

Add coldkey to the new map.

b39d51c

shamil-gadelshin added 4 commits October 10, 2025 15:19

Refactor code

99345b1

Add migration

cc324ec

Merge branch 'devnet-ready' into root-claim2

8d63857

Fix merge conflicts

1f1c7e7

shamil-gadelshin requested a review from camfairchild October 14, 2025 09:46

camfairchild reviewed Oct 14, 2025

View reviewed changes

Update pallets/subtensor/src/staking/claim_root.rs

3d3ef0d

Co-authored-by: Cameron Fairchild <[email protected]>

shamil-gadelshin requested a review from camfairchild October 14, 2025 12:50

Handle case for stake mismatch.

ab5a274

camfairchild requested changes Oct 14, 2025

View reviewed changes

Add proxy type.

db3a0f0

open-junius reviewed Oct 15, 2025

View reviewed changes

pallets/subtensor/src/migrations/migrate_remove_tao_dividends.rs Show resolved Hide resolved

shamil-gadelshin added 5 commits October 16, 2025 17:41

Add swap_coldkey support for root claim

c213dd0

Add swap_hotkey support for root claim

d6203c0

Remove PendingRootDivs map

7a2ebae

Claim all during network deregistration.

b0e346e

Modify default claim root key number

d68d3aa

shamil-gadelshin commented Oct 17, 2025

View reviewed changes

shamil-gadelshin requested review from camfairchild and open-junius October 17, 2025 13:53

sam0x17 previously approved these changes Oct 17, 2025

View reviewed changes

sam0x17 added the breaking-change This PR introduces a noteworthy breaking change label Oct 17, 2025

Introduce root claim threshold for subnets.

29e99d7

shamil-gadelshin dismissed sam0x17’s stale review via 29e99d7 October 20, 2025 12:26

Root claim #2053

Are you sure you want to change the base?

Root claim #2053

Uh oh!

Conversation

shamil-gadelshin commented Sep 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Root Claim / Airdrop

New extrinsics

Storage changes

Removed (obsolete storage maps)

Original PRs

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Swamination-Yuma commented Oct 14, 2025

Uh oh!

camfairchild left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

camfairchild commented Oct 15, 2025

Uh oh!

shamil-gadelshin left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sam0x17 commented Oct 17, 2025

Uh oh!

Swamination-Yuma commented Oct 17, 2025

Uh oh!

github-actions bot commented Oct 17, 2025

Uh oh!

shamil-gadelshin commented Oct 20, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

shamil-gadelshin commented Sep 12, 2025 •

edited

Loading

shamil-gadelshin left a comment •

edited

Loading